-
Notifications
You must be signed in to change notification settings - Fork 24.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[DOCS] Reformat split index API docs #46713
Conversation
Pinging @elastic/es-core-features |
Pinging @elastic/es-docs |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A couple editorial comments, but otherwise LGTM.
To split an index, | ||
the index must be marked as read-only | ||
and have a <<cluster-health,cluster health>> status of `green`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This reads as if it's the index that needs to be green, rather than the cluster. If you change the shrink prereqs, I'd make a similar change here:
Before you can split an index:
- The index must be read-only.
- The <<cluster-health, cluster health>> status must be green.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@@ -52,9 +103,9 @@ Splitting works as follows: | |||
* Finally, it recovers the target index as though it were a closed index which | |||
had just been re-opened. | |||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Like with shrinking, referring to splitting as "it" is a bit odd. If you make changes there, I'd make parallel changes here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed with 6f981b9.
==== Wait For Active Shards | ||
|
||
[[split-wait-active-shards]] | ||
==== Wait For active shards |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Lowercase for?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good catch. Fixed with 6f981b9.
Reformats the split API docs to align with the new API reference template.
Relates to #43765.